Skip to content

docs(send-video/send-image): add codec warning and edit caption atributes#18

Open
paolamayuri wants to merge 1 commit intoZ-API:mainfrom
paolamayuri:docs/add-codec-warning-and-edit-caption-attribute
Open

docs(send-video/send-image): add codec warning and edit caption atributes#18
paolamayuri wants to merge 1 commit intoZ-API:mainfrom
paolamayuri:docs/add-codec-warning-and-edit-caption-attribute

Conversation

@paolamayuri
Copy link
Copy Markdown
Contributor

No description provided.

Copy link
Copy Markdown
Contributor

@Lucas0204 Lucas0204 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

</ParamField>

<ParamField body="editImageMessageId" type="string">
Permite editar a mensagem (caption) de uma imagem enviada anteriormente. É necessário configurar o webhook antes de utilizar.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

aqui acredito que ficaria mais fluído e claro se deixasse o caption mais em evidência ao invés de dentro de parenteses, por exemplo:

Suggested change
Permite editar a mensagem (caption) de uma imagem enviada anteriormente. É necessário configurar o webhook antes de utilizar.
Permite editar o caption da mensagem de imagem enviada anteriormente. É necessário configurar o webhook antes de utilizar.

</ParamField>

<ParamField body="editVideoMessageId" type="string">
Permite editar a mensagem (caption) de um vídeo enviado anteriormente. É necessário configurar o webhook antes de utilizar.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

mesma situação da imagem:

Suggested change
Permite editar a mensagem (caption) de um vídeo enviado anteriormente. É necessário configurar o webhook antes de utilizar.
Permite editar o caption da mensagem de vídeo enviado anteriormente. É necessário configurar o webhook antes de utilizar.

</ParamField>

<ParamField body="editImageMessageId" type="string">
Allows editing the message (caption) of a previously sent image. It is required to configure the webhook before using this feature.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

mesmo cenário dos arquivos em português:

Suggested change
Allows editing the message (caption) of a previously sent image. It is required to configure the webhook before using this feature.
Allows editing the message caption of a previously sent image. It is required to configure the webhook before using this feature.

</ParamField>

<ParamField body="editVideoMessageId" type="string">
Allows editing the message (caption) of a previously sent video. It is required to configure the webhook before using this feature.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Allows editing the message (caption) of a previously sent video. It is required to configure the webhook before using this feature.
Allows editing the message caption of a previously sent video. It is required to configure the webhook before using this feature.

- **Por Base64**: caso você queira enviar o vídeo em formato Base64.

<Warning>
O vídeo deve estar codificado em **H.264** antes de ser enviado. Vídeos em outros codecs podem ser rejeitados ou não reproduzir corretamente no WhatsApp. O arquivo não deve ultrapassar **100MB**.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

seria melhor deixar essa parte como uma recomendação, exemplo: "Para um funcionamento mais previsível dessa API, procure sempre utilizar vídeos com CODEC H.264, pois é o formato aceito pelo Whatsapp. Em caso de vídeos outros CODECS, internamente fazemos um processamento e conversão do mesmo para H.264, o que pode gerar intermitências no envio, visto que esse processo de conversão de CODEC pode resultar em um vídeo mais pesado e, consequentemente, maior do que o aceito pelo Whatsapp. Ou seja, dependendo do CODEC do vídeo enviado para a API, caso ele seja pesado, o envio pode ou não ser executado, por conta disso, para uma operação mais previsível da API, recomendamos utilizar CODEC H.264"

Enfim, algo nesse sentido. Porque quando você coloca que o vídeo "deve estar codificado... ", dá a entender que o CODEC do vídeo é uma limitação, o que não é verdade, pois fazemos conversões de qualquer tipo de vídeo praticamente, daí poderia gerar confusão nos clientes. Ou seja, poderia acabar gerando uma preocupação desnecessário nos clientes que já utilizam hoje e funciona normalmente

- **By Base64**: if you want to send the video in Base64 format.

<Warning>
The video must be encoded in **H.264** before sending. Videos in other codecs may be rejected or not play correctly on WhatsApp. The file must not exceed **100MB**.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

mesma coisa do comentário do arquivo em português

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants